銀行振込(バーチャル口座) インタフェース
概要
リンクタイプ Plus決済では、決済手段として銀行振込(バーチャル口座)を利用することが可能です。銀行振込(バーチャル口座)を利用するには、実行パラメータセットに銀行振込(バーチャル口座)に必要なパラメータを渡す必要があります。
リンクタイプ Plus決済で銀行振込(バーチャル口座)が完了すると、遷移先URLに銀行振込(バーチャル口座)の結果パラメータが返却されます。
遷移先URLは設定により異なるパラメータを参照します。
詳細は「決済画面からの加盟店様サイトへの遷移」をご覧ください。
入出力パラメータ仕様
実行パラメータ仕様
銀行振込(バーチャル口座)固有の実行パラメータは以下の通りです。
json key | 詳細 | 指定可能箇所 | システムデフォルト設定 | ||
---|---|---|---|---|---|
リンクタイプPlus決済URL | 加盟店デフォルト設定 | ||||
virtualaccount |
銀行振込(バーチャル口座)固有実行パラメータ銀行振込(バーチャル口座)の実行パラメータセットです。 |
〇 | 〇 | (null) | |
TradeDays | 半角数字2桁
振込有効日数取引が有効な日数を指定してください。管理画面で設定した値を使用します。 お客様には、出力パラメータで返される「取引有効期限」を振込期限として案内してください(振込依頼メールには本パラメータで指定された振込期限が記載されます)。 尚、振込期限内に入金がない場合、当該取引は取引猶予期間後に有効期限切れとなり、払い出されたバーチャル口座は利用不能となります。 |
〇 | 〇 | 7 | |
TradeReason | 全半角64桁
振込事由取引の内容を設定してください。本項目は、振込依頼メールの「利用内容」欄に記載されます。 |
〇 | 〇 | (null) | |
TradeClientName | 全半角英数64桁
振込依頼者氏名振込依頼者の氏名を設定してください。全角、半角文字が利用可能です。 |
〇 | - | (null) | |
TradeClientMailaddress | 半角英数記号256桁
振込依頼者メールアドレス振込を依頼するお客様のメールアドレスを設定してください。設定した場合は、当該メールアドレスに振込依頼メールが送信されます。 未設定の場合は、お客様に対して加盟店様から振込依頼をしてください。 |
〇 | - | (null) |
結果パラメータ仕様
銀行振込(バーチャル口座)を選択した場合に、加盟店様に返却する銀行振込(バーチャル口座)固有の結果パラメータは以下の通りです。
virtualaccount |
銀行振込(バーチャル口座)固有部銀行振込(バーチャル口座)固有の結果パラメータセットです。 |
|
---|---|---|
Status |
取引状態取引の状態を示す以下の値が設定されます。TRADING:取引中(お客様に振込依頼後、未入金状態) TRANSFERRED:入金済み |
|
TranDate | 半角数字14桁
決済日時決済を行った日時が設定されます。(yyyyMMddHHmmss形式) |
|
TradeDays | 半角数字2桁
振込有効日数取引が有効な日数が設定されます。 |
|
ExpireDate | 半角数字8桁
取引有効期限取引の有効期限が設定されます。(yyyyMMdd形式) |
|
TradeReason | 全半角64桁
振込事由取引の内容が設定されます。 |
|
TradeClientName | 全半角64桁
振込依頼者氏名振込依頼者の氏名が設定されます。 |
|
TradeClientMailaddress | 半角英数記号256桁
振込依頼者メールアドレス振込を依頼するお客様のメールアドレスが設定されます。 |
|
AccountID | 半角英数12桁
仮想口座ID取引で使用する、仮想口座に割り当てられるIDが設定されます。 |
|
TradeCode | 半角英数7桁
振込コード振込時に「依頼人名」に入力するコードが設定されます。お客様が振込を行う際に「振込依頼人名」欄に振込コード+お客様氏名を入力するように案内してください。 |
|
BankCode | 半角英数4桁
銀行コード振込先口座の銀行コードが設定されます。 |
|
BankName | 全半角30桁
銀行名振込先口座の銀行名が設定されます。 |
|
BranchCode | 半角英数3桁
支店コード振込先口座の支店コードが設定されます。 |
|
BranchName | 全半角30桁
支店名振込先口座の支店名が設定されます。 |
|
AccountType | 半角英数1桁
振込先口座種別振込先口座の預金種別が設定されます。 |
|
AccountNumber | 半角数字7桁
振込先口座番号振込先口座の口座番号が設定されます。 |